你可以请求一个 transfer
对象向个人用户或企业账户发起微信(仅支持向个人用户的零钱或银行卡转账)、支付宝或者银行卡的转账。所有与企业付款相关的要素信息都存储在 transfer
对象之中,你可以通过发起企业付款请求创建新的 transfer
对象,也可以随时查看企业付款对象的状态。每个 transfer
对象都拥有一个标识 id
,该 id
在系统内唯一。
注:微信企业付款区分"企业付款到零钱"和"企业付款到银行卡",使用此功能时请确保在微信处开通相应产品。此外,使用微信服务商模式商户暂不支持企业付款。
属性 | 描述 |
---|---|
id string | 企业付款对象 id ,由 Ping++ 生成,27 位长度字符串。 |
object string | 值为 "transfer"。 |
type string | 付款类型,转账到个人用户为 b2c,转账到企业用户为 b2b(wx、wx_pub、wx_lite 和 balance 渠道的企业付款,仅支持 b2c)。 |
created timestamp | 创建时间,用 Unix 时间戳表示。 |
time_transferred timestamp | 支付完成时间, 用 Unix 时间戳表示。由第三方支付渠道返回。 |
livemode boolean | 是否是 live 模式。 |
status string | 付款状态。目前支持 4 种状态:pending: 处理中; paid: 付款成功; failed: 付款失败; scheduled: 待发送。 |
app expandable string | 转账对应的 app 对象的 id 。expandable 可展开,查看如何获取App ID。 |
channel string | 付款使用的第三方支付渠道名称。目前支持 wx (微信 App)、wx_pub (微信 JSAPI)、wx_lite (微信小程序)、alipay (支付宝)、unionpay (银联电子代付)、allinpay (通联代付)、jdpay (京东代付)和balance (余额)。 |
order_no string | 付款使用的商户内部订单号。wx/wx_pub/wx_lite 规定为 1 ~ 32 位不能重复的数字字母组合; alipay 为 1 ~ 64 位不能重复的数字字母组合;unionpay 为 1 ~ 16 位的纯数字; allinpay 为 20 ~ 40 位不能重复的数字字母组合,必须以签约的通联的商户号开头(建议组合格式:通联商户号 + 时间戳 + 固定位数顺序流水号,不包含+ 号); jdpay 为 1 ~ 64 位不能重复的数字字母组合;balance 为 1 ~ 64 位不能重复的数字字母组合,支持"-"和"_"。 |
amount int | 付款金额,相关渠道的限额,请查看帮助中心。单位为对应币种的最小货币单位,例如:人民币为分。 |
amount_settle int | 清算金额,单位为对应币种的最小货币单位,例如:人民币为分。 |
currency string | 三位 ISO 货币代码,目前仅支持人民币 cny。 |
recipient string | 接收者 id,使用微信企业付款到零钱时为用户在 wx 、wx_pub 及 wx_lite 渠道下的 open_id ,使用企业付款到银行卡时不需要此参数;渠道为 unionpay 时,不需要传该参数;渠道为 alipay 时,若 type 为 b2c,为个人支付宝账号,若 type 为 b2b,为企业支付宝账号;渠道为 jdpay 和 allinpay 时,可不传该参数。渠道为 balance 时,为用户在当前 app 下的用户 id。 |
description string | 备注信息,最多 255 个 Unicode 字符。渠道为 unionpay 时,最多 99 个 Unicode 字符,不可包含特殊字符;渠道为 wx 、wx_pub 、wx_lite 时,最多 99 个英文和数字的组合或最多 33 个中文字符,不可包含特殊字符;渠道为 alipay 和 jdpay 时,最多 100 个 Unicode 字符;渠道为 allinpay 时,最多 30 个 Unicode 字符;渠道为 balance 时,最多 255 个 Unicode 字符。 |
metadata hash | 参考元数据。 |
transaction_no string | 交易流水号,由第三方渠道提供。 |
failure_msg string | 企业付款订单的错误消息的描述。 |
extra hash | transfer 相关的附加参数,详情参考请求参数说明。 |
{
"id": "tr_HqbzHCvLOaL4La1ezHfDWTqH",
"object": "transfer",
"type": "b2c",
"created": 1432724825,
"time_transferred": null,
"livemode": true,
"status": "pending",
"app": "app_1Gqj58ynP0mHeX1q",
"channel": "wx_pub",
"order_no": "123456789",
"amount": 100,
"amount_settle": 100,
"currency": "cny",
"recipient": "o7zpMs5MW2-52GAy5hRrjdYVCktU",
"description": "Your Description",
"transaction_no": "1000018301201505200184147302",
"failure_msg":null,
"extra": {
"user_name": "User Name",
"force_check": true
}
}